home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 2000 February / MacFormat 87.iso / Shareware Plus / Utilities / MindControl / MindControl.rsrc / TEXT_2330_Chapter 4 - Scripting MindControl.txt < prev    next >
Encoding:
Text File  |  2000-01-10  |  3.6 KB  |  105 lines
  1. Scripting MindControl
  2.  
  3. MindControl's basic functions are scriptable, so you can use AppleScript to automate the addition or deletion of commands. This powerful capability allows you to condense multiple actions into an executable script (that MindControl can launch for you). In addition, because AppleScripts can involve multiple applications, you can command MindControl with values gathered from web browsers, word processors, databases and other scriptable applications.
  4.  
  5. AppleScript communicates with MindControl through messages called Apple events. MindControl responds to these events by performing actions, such as adding a command. To view the events available for scripting MindControl, open Script Editor (it's bundled with the Macintosh OS), select Open Dictionary from the File menu and navigate to the MindControl application. Make your selection and click Open.
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31. MindControl offers the following scriptable events: 
  32.  
  33. NewCommand
  34. This adds a new command based on file path, command and description. The syntax is:
  35. NewCommand value Command value Description value.
  36.  
  37. NewCommand: precedes a value for the path to a file, document or drive.
  38.  
  39. Command: precedes a value for the command name.
  40.  
  41. Description: precedes a value for the command description.
  42.  
  43.  
  44. NewURL
  45. This adds a new URL based on URL path, command and description. The syntax is:
  46. NewURL value Command value Description value.
  47.  
  48. NewURL: precedes a value for the URL path.
  49.  
  50. Command: precedes a value for the command name.
  51.  
  52. Description: precedes a value for the command description.
  53.  
  54.  
  55. DeleteCommandURL
  56. This deletes a user-defined command from the list.
  57.  
  58. DeleteCommandURL: precedes a value for the command or URL to delete.
  59.  
  60.  
  61. Sample scripts
  62.  
  63. The following sample scripts assign values to variables and then use the variables in statements that instruct MindControl to perform specific actions. 
  64.  
  65. To add a command:
  66.  
  67. tell application "MindControl"
  68.     set thefile to "Macintosh HD:Desktop Folder:Demo folder" as alias
  69.     set thecommand to "demo"
  70.     set thedescription to "This is a demonstration"
  71.     NewCommand thefile Command thecommand Description thedescription
  72. end tell
  73.  
  74. To delete a command:
  75.  
  76. tell application "MindControl"
  77.     set delcmd to "demo"
  78.     DeleteCommandURL delcmd
  79. end tell
  80.  
  81. To add a URL command:
  82.  
  83. tell application "MindControl"
  84.     set theurl to "mailto:mindcontrol@mindvision.com"
  85.     set thecommand to "letter"
  86.     set thedescription to "send MindVision e-mail"
  87.     NewURL theurl Command thecommand Description thedescription
  88. end tell
  89.  
  90. To delete a URL command:
  91.  
  92. tell application "MindControl"
  93.     set delcmd to "letter"
  94.     DeleteCommandURL delcmd
  95. end tell
  96.  
  97. Scripts that are more complex may call on other applications to return values for MindControl statements. A new command name, for example, could come from a heading in a web browser window. Or a script might gather URL paths from a spreadsheet. 
  98.  
  99. Where to download scripts
  100. To download working examples of MindControl scripts, visit MindControl Extras at http://www.mindvision.com/mindcontrol/extras. Here you can find scripts that make MindControl even more useful. For example, one script will create a MindControl command for the web page currently displayed by your web browser. Another script will read the sender's address from an e-mail message and create a MindControl command for that address.
  101.  
  102. Share useful tips and scripts
  103. If you come up with a novel use for MindControl, we invite you to share it with others. This could be a tip for using MindControl, or it could be an executable script. Just go to the MindControl Extras site and submit your information. We will review all submissions and post the approved ones on the web site where everyone can access them.
  104.  
  105.